home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / wminf102.zip / WMINFO.DOC < prev    next >
Text File  |  1993-01-07  |  50KB  |  1,141 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                WMINFO! v1.02
  14.  
  15.                  Activity Log Analyzer for WILDMAIL! v2.+
  16.  
  17.  
  18.            (c) Copyright 1992, 1993 by Online Computer Resources
  19.  
  20.  
  21.                   4330-J Clayton Road, Concord, CA 94521
  22.                 Voice: (510) 687-1122  BBS: (510) 687-0236
  23.  
  24.                             All Rights Reserved
  25.                              Revised: 01/07/93
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                   WMINFO!
  34.  
  35.                              TABLE OF CONTENTS
  36.  
  37.  
  38.  
  39.           INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   1
  40.  
  41.           ABOUT THIS DOCUMENTATION  . . . . . . . . . . . . . . . . . .   1
  42.  
  43.           PROGRAM AUTHOR  . . . . . . . . . . . . . . . . . . . . . . .   1
  44.  
  45.           EVALUATION KEY  . . . . . . . . . . . . . . . . . . . . . . .   2
  46.  
  47.           FILES INCLUDED  . . . . . . . . . . . . . . . . . . . . . . .   3
  48.  
  49.           INSTALLATION  . . . . . . . . . . . . . . . . . . . . . . . .   3
  50.  
  51.           COMMAND LINE OPTIONS  . . . . . . . . . . . . . . . . . . . .   4
  52.                /L:<filename.ext>  . . . . . . . . . . . . . . . . . . .   4
  53.                /A:<filename.ext>  . . . . . . . . . . . . . . . . . . .   4
  54.                /Q . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  55.                /C . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  56.                /N . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  57.  
  58.           FILE NAMING CONVENTIONS . . . . . . . . . . . . . . . . . . .   6
  59.  
  60.           COMPRESSING REPORTS FOR DELIVERY  . . . . . . . . . . . . . .   7
  61.  
  62.           EMS USAGE . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  63.  
  64.           HUB SPECIFIC REPORTS  . . . . . . . . . . . . . . . . . . . .   7
  65.                /H . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  66.  
  67.           SORT FIELD SELECTION  . . . . . . . . . . . . . . . . . . . .   9
  68.                /E . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  69.  
  70.           NODE SPECIFIC REPORTS . . . . . . . . . . . . . . . . . . . .   9
  71.                /D . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  72.                /T . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  73.                /M . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  74.                /G . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  75.  
  76.           NETMAIL MESSAGE GENERATION  . . . . . . . . . . . . . . . . .  12
  77.  
  78.           SPLITTING THE LOG FILE  . . . . . . . . . . . . . . . . . . .  13
  79.                /S . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.                                      i
  90.  
  91.  
  92.  
  93.                                   WMINFO!
  94.  
  95.                              TABLE OF CONTENTS
  96.  
  97.  
  98.  
  99.           EXCLUDING INFORMATION FROM REPORTS  . . . . . . . . . . . . .  13
  100.  
  101.           EXCLUDING NODE ADDRESSES  . . . . . . . . . . . . . . . . . .  14
  102.  
  103.           EXCLUDING CONFERENCES . . . . . . . . . . . . . . . . . . . .  14
  104.  
  105.           SPECIFICATIONS  . . . . . . . . . . . . . . . . . . . . . . .  15
  106.  
  107.           MEMORY REQUIREMENTS . . . . . . . . . . . . . . . . . . . . .  15
  108.  
  109.           PROCESSING SPEED  . . . . . . . . . . . . . . . . . . . . . .  15
  110.  
  111.           CONFERENCES SUPPORTED . . . . . . . . . . . . . . . . . . . .  15
  112.  
  113.           NODES SUPPORTS  . . . . . . . . . . . . . . . . . . . . . . .  15
  114.  
  115.           TECHNICAL SUPPORT . . . . . . . . . . . . . . . . . . . . . .  16
  116.  
  117.           30 DAY EVALUATION COPY  . . . . . . . . . . . . . . . . . . .  16
  118.  
  119.           PRODUCT REGISTRATION  . . . . . . . . . . . . . . . . . . . .  16
  120.  
  121.           LICENSING AND DISTRIBUTION AGREEMENT  . . . . . . . . . . . .  17
  122.  
  123.           NO WARRANTY . . . . . . . . . . . . . . . . . . . . . . . . .  18
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.                                     ii
  150.  
  151.  
  152.           WMINFO! v1.02                                          Page  1
  153.           INTRODUCTION
  154.  
  155.  
  156.  
  157.           INTRODUCTION
  158.  
  159.           WMINFO! is a utility designed to read the contents of the activity
  160.           log file produced by WILDMAIL! v2.02 (and higher) and produce
  161.           various statistical reports and display screens (files) for use in
  162.           WILDCAT! v3.00 and higher.
  163.  
  164.           Depending on the degree of reporting desired, individual reports
  165.           may also be generated for your downlink nodes (systems that pickup
  166.           echo/netmail from your system).  WMINFO! will then generate the
  167.           appropriate netmail message(s) and compress the reports into a ZIP
  168.           file and then place it in the proper directory for your mailer to
  169.           automatically send to your nodes.  Additional features like log
  170.           file maintenance and automatic configuration make it easy to
  171.           utilize this information and simplifies the installation.
  172.  
  173.  
  174.           ABOUT THIS DOCUMENTATION
  175.  
  176.           This document is a reference manual on installing and using
  177.           WMINFO!.  Since WMINFO! requires the use of a log file generated
  178.           by WILDMAIL!, if you don't already use WILDMAIL!, this program
  179.           won't be of much use to you.  If you do, you will be pleased to see
  180.           how much it can do for you!
  181.  
  182.  
  183.           PROGRAM AUTHOR
  184.  
  185.           WMINFO! v1.02 was written by Joe Martin of Online Computer
  186.           Resources with a helping hand from the author of WILDMAIL! v3.00's
  187.           configuration program (WMCONFIG!) Eric Cozzi.
  188.  
  189.           This programs intent was to provide a means with which to measure
  190.           conference and individual node's activity and to provide a stepping
  191.           stone to an efficient and easy to use method of cost accounting for
  192.           use when WILDMAIL! v3.00 is released.
  193.  
  194.           With the release of WMINFO! unfolds a whole new era in echomail
  195.           management.  We plan on evolving this product into a complete stand
  196.           alone program that operates much in the same manner that MSI's
  197.           WCPRO! does.  A simple front end menuing system to control a very
  198.           powerful program which will provide detailed accounting of mail
  199.           activity in just about any facet of echomail the user desires.
  200.  
  201.  
  202.  
  203.           WMINFO! v1.02                                          Page  2
  204.           EVALUATION KEY
  205.  
  206.  
  207.  
  208.           30 DAY EVALUATION KEY
  209.  
  210.           WMINFO! utilizes a special file to activate its usage for a period
  211.           of 30 days.  This method allows the program to be fully utilized
  212.           with all options enabled for the duration of the evaluation period.
  213.           If the product hasn't been registered after the thirty days,
  214.           WMINFO! will inform you it has expired and will simply cease to
  215.           run.
  216.  
  217.           Since the current method of distribution prevents a "dated" key
  218.           file from be included in WMINF101.ZIP, you must dial up the support
  219.           board (listed below) and create this special key file.  Selecting
  220.           the "Create WMIN.ID Key File" option from the Main Menu initiates
  221.           this process and you simply enter in the required information and
  222.           then follow the instructions for downloading.
  223.  
  224.           The WMINFO! support board may reached by dialing:
  225.  
  226.                     (510) 687-0236 - USR v32/HST
  227.                     (510) 687-2134 - v32bis
  228.  
  229.           Only one key per person/registration number will be allowed.
  230.  
  231.  
  232.  
  233.  
  234.           WMINFO! v1.02                                          Page  3
  235.           INSTALLATION
  236.  
  237.  
  238.  
  239.           FILES INCLUDED
  240.  
  241.           Your WMINFO! installation kit is distributed in a file called
  242.           WMINF102.ZIP and contains these files:
  243.  
  244.           README.1ST          Comments and any last minute changes.
  245.  
  246.           REGISTER.DOC        Form used to simplify product registration.
  247.  
  248.           WMINFO.EXE          The executable.
  249.  
  250.           WMINFO.DOC          This documentation file.
  251.  
  252.           EX-NODES.LST        Sample ASCII text file containing the node
  253.                               addresses to exclude from the various reports.
  254.  
  255.           EX-CONFS.LST        Sample ASCII text file containing the
  256.                               conference names to exclude from the reports.
  257.  
  258.  
  259.  
  260.           INSTALLATION
  261.  
  262.           Installation and setup of WMINFO! is relatively simple and straight
  263.           forward.  Outlined below is the recommended procedure when
  264.           installing the program.
  265.  
  266.           1)   Using PKUNZIP, uncompress the WMINF102.ZIP into your existing
  267.                WILDMAIL directory.  (Possibly C:\WILDMAIL)  This is very
  268.                important as WMINFO! must be EXECUTED from the WILDMAIL!
  269.                directory because it reads/uses various configuration files
  270.                that WILDMAIL! also uses.
  271.  
  272.           2)   Use the CD\ command and change directories to the directory
  273.                you just un-compressed the WMINF101.ZIP file in.
  274.  
  275.           2)   Edit the EX-NODES.LST and EX-CONFS.LST as appropriate.  Refer
  276.                to the section (in this DOC file) for these files
  277.                configuration requirements for specific details.  Please note,
  278.                these files are not required and are only used if they exist
  279.                in the same directory as WILDMAIL!.
  280.  
  281.           3)   Depending on what information you'd like WMINFO! to produce,
  282.                enter WMINFO followed by the desired command line parameters
  283.                and WMINFO! will take off from there.  By entering WMINFO ?,
  284.                a complete list of available command line parameters will be
  285.                displayed.
  286.  
  287.  
  288.  
  289.           WMINFO! v1.02                                          Page  4
  290.           COMMAND LINE OPTIONS
  291.  
  292.  
  293.  
  294.           COMMAND LINE OPTIONS
  295.  
  296.           At present, there's 13 different command line parameters which can
  297.           be used when executing WMINFO!.  By command line parameters, we
  298.           mean they are added to the line that you execute WMINFO from.  For
  299.           example:
  300.                          WMINFO /C /H /L:WM-1192.LOG /A:AREAS.TMP
  301.  
  302.           The exact ordering of the parameters on the command line is
  303.           insignificant as long as each parameter's requirements are adhered
  304.           to.  All parameters must be separated by a space as shown above.
  305.           Following is a breakdown of each of these and their usage.
  306.  
  307.           /L:<filename.ext>
  308.                This parameter is used to override the specified log file name
  309.                as found in the WM.CFG file.  This could be useful if you wish
  310.                to process a specific months log file which uses a different
  311.                name and possibly resides in a different sub-directory on a
  312.                different drive.
  313.  
  314.                     Example Usage:  WMINFO /L:C:\TEMP\WM-1192.LOG
  315.  
  316.                Please note that there MUST NOT be any spaces between the /L:
  317.                and the DOS path and file name as shown above.  If only the
  318.                file name is specified, it's assumed to be in the current sub-
  319.                directory.
  320.  
  321.  
  322.           /A:<filename.ext>
  323.                This parameter functions EXACTLY the same as the above /L:
  324.                parameter does with the exception that this will override the
  325.                default areas file name of AREAS.BBS and allow you to specify
  326.                which file name you wish to use.  As with the /L: parameter,
  327.                complete DOS path names are allowed.
  328.  
  329.                     Example Usage:  WMINFO /A:C:\AREAS.TMP
  330.  
  331.                This file is used to specify which echomail area (conference)
  332.                that is to be associated with a given conference number within
  333.                WILDCAT!.  This file also specifies the downlink node
  334.                address(es) that pickup and send mail with your system.
  335.  
  336.                It should noted that there's nothing that needs to be done to
  337.                this file to use WMINFO!.  WMINFO! simply reads the file for
  338.                the conference specific information and then carries on.
  339.  
  340.  
  341.  
  342.  
  343.           WMINFO! v1.02                                          Page  5
  344.           COMMAND LINE OPTIONS
  345.  
  346.  
  347.  
  348.           /Q
  349.                When operating WMINFO!, a statistical screen is presented with
  350.                complete information about the totals and activity being
  351.                reported.  This option is used to turn off the statistics
  352.                screen thereby saving a bit of the CPU's resources and
  353.                possibly speeding up the processing time.
  354.  
  355.                     Example Usage: WMINFO /Q
  356.  
  357.  
  358.           /C
  359.                WMINFO! generates 5 different files for use as display files
  360.                within WILDCAT!.  There's 2 different versions of the same
  361.                files that can be produced depending on the use (non-use) of
  362.                this command line parameter.
  363.  
  364.                The default version (by omitting this parameter) creates
  365.                WMINFO1.ASC thru WMINFO5.ASC in the current directory.  These
  366.                are standard ASCII text type files that can be used for
  367.                printing at a later date in time if so desired.
  368.  
  369.                Using this option will instruct WMINFO! to automatically
  370.                insert the WILDCAT! specific @nn@ color codes and change the
  371.                extension of the file name from .ASC to .BBS leaving the
  372.                primary name the same (WMINFO1 thru WMINFO5).  Then via a user
  373.                defined batch file, these files could then be renamed
  374.                appropriately and copied into their respective directories.
  375.  
  376.                Shown below is a brief description of each of these files.
  377.  
  378.                     WMINFO1.BBS    Echomail Summary Information
  379.                     WMINFO2.BBS    Regular Mail Packet Activity
  380.                     WMINFO3.BBS    Visiting Node Mail Packet Activity
  381.                     WMINFO4.BBS    Echomail Conference Activity
  382.                     WMINFO5.BBS    PassThru Conference Activity
  383.  
  384.  
  385.           /N
  386.                When WMINFO! creates the above display files, it includes the
  387.                default headers and footers.  For those that wish to use their
  388.                own custom headers and footers, this option can be specified
  389.                to turn these off.  If this option is selected, it would now
  390.                be up to the user to create a batch file that will add in the
  391.                desired headers and footers.
  392.  
  393.                For example, let's say the you wish to create a output file
  394.                called HELLO9.BBS, placed in the C:\WC30\DISP directory using
  395.                a header file called HEADER.BBS and a footer file called
  396.                FOOTER.BBS.
  397.  
  398.  
  399.  
  400.           WMINFO! v1.02                                          Page  6
  401.           COMMAND LINE OPTIONS
  402.  
  403.  
  404.  
  405.                The batch file "section" to accomplish this would be something
  406.                like:
  407.  
  408.                @echo off
  409.                cd\wildmail
  410.                copy HEADER.BBS+WMINFO1.BBS+FOOTER.BBS C:\WC30\DISP\HELLO9.BBS
  411.  
  412.                If the /C parameter is used in conjunction with the /N option,
  413.                the color codes are left untouched in the BODY of the report,
  414.                so any desired colors in the header and footers would then be
  415.                the users responsibility to ensure they are properly defined.
  416.  
  417.  
  418.  
  419.           FILE NAMING CONVENTIONS
  420.  
  421.           WMINFO! has the ability to create up to 3 different reports on a
  422.           node by node basis.  So if you take that figure and multiply it by
  423.           75 possible downlink node addresses, you can see that this can add
  424.           up to a rather large amount of report files being generated.
  425.  
  426.           To accommodate this situation, WMINFO! produces a sequence of
  427.           numbered reports prefixed by the reports type.  Shown below are the
  428.           available reports and their possible file names.
  429.  
  430.                RECVD-08.RPT   This is the mail received report generated for
  431.                               node 08 via the /D parameter.
  432.  
  433.                NDMSG-08.RPT   This is the report generated for all the mail
  434.                               on a daily basis that was sent to (or packed
  435.                               up for) node 08 via the /M parameter.
  436.  
  437.                SUMRY-08.RPT   This is the summary report of all the mail
  438.                               sent to node 08 via the /T parameter.
  439.  
  440.           The number found in the file name is one generated internally by
  441.           WMINFO! and in no way relates to the node's actual Fido style
  442.           address.  Using this method of file name assignment makes it easy
  443.           for WMINFO! to keep track of what file(s) go to what node addresses
  444.           depending on what command line parameters were used at execution
  445.           time.
  446.  
  447.           The downside to this method is that it's difficult to know what
  448.           report goes to what node address when a human looks at the file
  449.           name.  The only way to know for sure is to actually view the
  450.           contents of the report.  But considering that WMINFO! has the
  451.           ability to automatically bundle up each respective node's reports
  452.           automatically, it's usually of little concern for the person
  453.           generating the reports.
  454.  
  455.  
  456.  
  457.           WMINFO! v1.02                                          Page  7
  458.           COMMAND LINE OPTIONS
  459.  
  460.  
  461.  
  462.           To put this into perspective, all reports numbered xxxxx-08.RPT are
  463.           created for the same Fido style node address and different numbers
  464.           indicate different addresses.
  465.  
  466.  
  467.           COMPRESSING REPORTS FOR DELIVERY
  468.  
  469.           By selecting the /G command line parameter (in conjunction with any
  470.           combination of /T /M /D parameters) this instructs WMINFO! to use
  471.           PKware's PKZIP.EXE utility to compress the selected reports and
  472.           place them in the OUTBOUND directory as defined in the WM.CFG file
  473.           found in the \WILDMAIL directory.  WMINFO! also creates a Netmail
  474.           message with the attached archive name of the compressed reports
  475.           (in the subject line) and places it in the MATRIXMAIL directory as
  476.           also defined in WM.CFG file.
  477.  
  478.           Unfortunately this is the only compression format supported at this
  479.           time due in part to the way each compression utility differently
  480.           handles the screen displays.  In the future, look to see this
  481.           changed to use the compression format defined by the TYPEPACK node
  482.           specific definition found in the WM.CFG file.
  483.  
  484.           If the /G parameter is omitted when using the any combination of
  485.           the /T /M /D command line parameters, the generated reports will
  486.           remain the \WILDMAIL directory for later review.
  487.  
  488.  
  489.           EMS USAGE
  490.  
  491.           WMINFO! automatically detects the presence of EMS memory and will
  492.           make use of it if there is sufficient room to store the contents
  493.           of memory to when it swaps out (creates another copy of
  494.           COMMAND.COM) to execute the compression utility PKZIP.EXE.
  495.  
  496.           If there isn't enough EMS memory available, then the swapping will
  497.           be done to disk instead.  Once the compression process has been
  498.           completed, WMINFO! will swap itself back into base memory either
  499.           from EMS (or disk) and continue on.
  500.  
  501.  
  502.           HUB SPECIFIC REPORTS
  503.  
  504.           Currently WMINFO! only supports one Hub specific report.  Shown
  505.           below is the command line parameter that can be used to invoke this
  506.           report.
  507.  
  508.           /H
  509.                This parameter is designed to get a quick overall look at how
  510.                all the conferences are operating on your system.  The report
  511.                produced is called DTL-HUB.RPT and is created in the \WILDMAIL
  512.                
  513.  
  514.  
  515.           WMINFO! v1.02                                          Page  8
  516.           COMMAND LINE OPTIONS
  517.  
  518.  
  519.  
  520.           /H - (continued)
  521.                directory.  Information like daily totals, accumulative totals
  522.                and downlink nodes receiving each conference can often times
  523.                be useful in determining not only conference specific
  524.                activity, but also any interruptions in the mail flow.
  525.  
  526.                When this report is generated, normal pagination is active for
  527.                easy viewing when you want to print the report.  Shown below
  528.                is a sample format report.
  529.  
  530.  
  531.              ┌────────────────────────────────────────────────────────────┐
  532.              │ WMINFO! v1.02      HUB Activity Report      Date: 12/18/92 │
  533.              └────────────────────────────────────────────────────────────┘
  534.  
  535.               Num  Echomail Area     01   02   03   04   MsgTotals  Nodes
  536.               ───  ──────────────── ──── ──── ──── ────  ─────────  ─────
  537.                 P  12_STEPS           13   12   14    8      47 Ts     1
  538.                                        -    2    -    1       3 Ex
  539.                 P  4DOS               18   41   37   25     121 Ts     3
  540.                                        -    -    -    -       0 Ex
  541.                23  ABLED              30   82   50   46     208 Ts     4
  542.                                        4    9    1    3      17 Ex
  543.                24  ABLENEWS            3    1    9    0      12 Ts     3
  544.                                        -    -    -    -       0 Ex
  545.                25  AD&D               80   63   59   80     282 Ts     2
  546.                                        -    -    -    -       0 Ex
  547.  
  548.                Num -
  549.                     This field is used to indicate either of two possible
  550.                     values.  A number displayed here represents the actual
  551.                     WILDCAT! conference number and the letter P is used to
  552.                     indicate this conference is a pass-thru type.
  553.  
  554.                Echomail Area -
  555.                     This field displays the complete Fido style area name.
  556.                     This should not be confused with the WILDCAT! conference
  557.                     description.
  558.  
  559.                01..04 -
  560.                     The numbers displayed here are the actual days of the
  561.                     month that WMINFO! is reporting activity on.  Two
  562.                     different sets of information are maintained on a daily
  563.                     basis.  The top portion indicates the message tossed
  564.                     (Ts) into the system and the bottom portion indicates
  565.                     the number of messages that have been extracted (Ex)
  566.                     from your system.  By extracted, we mean callers have
  567.                     physically entered new messages onto your system and
  568.                     WILDMAIL! has extracted them and sent them out into the
  569.                     network.  Any values of 0 are indicated by a single dash
  570.                     '-' character for easier viewing.
  571.  
  572.  
  573.  
  574.           WMINFO! v1.02                                          Page  9
  575.           COMMAND LINE OPTIONS
  576.  
  577.  
  578.  
  579.                     WMINFO! currently supports up to 31 days of activity to
  580.                     report upon.  This means the report will automatically
  581.                     adjust itself by adding in the appropriate day columns
  582.                     and adjusting the sizes of the headers.  Because this
  583.                     report can be rather wide, if you want to print this
  584.                     out, you might have to put your printer into condensed
  585.                     mode to have it all fit on a single page.
  586.  
  587.                     Because your WM.LOG file can be any length, WMINFO! will
  588.                     only produce a report of the FIRST 31 days of the log
  589.                     file.  If you wish to report any additional information,
  590.                     you should use the /S (Split Log File) command line
  591.                     parameter first and then re-execute WMINFO!.
  592.  
  593.                MsgTotals -
  594.                     This field indicates the accumulative totals for the
  595.                     days in the report.  "Ts" is used to indicate messages
  596.                     tossed and "Ex" indicates messages extracted.
  597.  
  598.                Nodes -
  599.                     This field is used to indicate the number of nodes that
  600.                     are picking up mail from you for this conference.
  601.  
  602.  
  603.           SORT FIELD SELECTION
  604.  
  605.           /E
  606.                By default, conference areas processed by WMINFO! are sorted
  607.                by conference number with P (passthrus) heading the list.
  608.                Using this command line parameter will override the default
  609.                sort and use the conference AREA name as the primary sort
  610.                field.  This is handy when reading the various reports.
  611.  
  612.  
  613.           NODE SPECIFIC REPORTS
  614.  
  615.           WMINFO! will generate reports for only those node addresses found
  616.           in the AREAS.BBS file at execution time.  Since any number of
  617.           "outside node addresses" can be recorded in your WM.LOG file,
  618.           WMINFO! limits the report generation to only these nodes.
  619.  
  620.           Shown below is a list of the different reports available and it's
  621.           respective command line parameter.
  622.  
  623.           /D
  624.                WMINFO! has the ability to generate on a daily basis, for each
  625.                node found in the AREAS.BBS file, a report of every .PKT file
  626.                that each node has sent to your system.  As was mentioned
  627.                earlier, this report is named RECVD-xx.RPT (where xx equals
  628.                a temporary node number).  Shown below is a sample report.
  629.  
  630.  
  631.  
  632.           WMINFO! v1.02                                          Page 10
  633.           COMMAND LINE OPTIONS
  634.  
  635.  
  636.  
  637.      ┌───────────────────────────────────────────────────────────────────┐
  638.      │ WMINFO! v1.02     Received Mail from 1:161/503     Date: 12/17/92 │
  639.      └───────────────────────────────────────────────────────────────────┘
  640.  
  641.                     Received Mail For Tuesday - December 1, 1992
  642.  
  643.          Time    Packet Name   Pkt Size   Conf    Toss   Sent To Address
  644.        ────────  ────────────  ─────────  ─────  ──────  ───────────────
  645.        23:49:21  00178FF6.PKT        372     0       0   1:161/123
  646.                  27930441.PKT      4,490     1       3   1:161/123
  647.                  27931121.PKT      1,097     1       2   1:161/123
  648.                  27932305.PKT      5,761     2       5   1:161/123
  649.                  27932670.PKT     26,488     3      16   1:161/123
  650.  
  651.        Totals =>  Pkt Count: 5    Bytes: 38,208     Tossed: 26
  652.  
  653.  
  654.                Most all of the information shown above is self-explanitory,
  655.                but we'll cover it here anyway.
  656.  
  657.                Time -
  658.                     This is the time of day in 24 hour format that the
  659.                     packet was created (not the processing time).  This
  660.                     column will show the time for the first PKT and then any
  661.                     remaining PKT file(s) with the same time will have this
  662.                     redundant information removed for easier viewing.
  663.  
  664.                Packet Name -
  665.                     This is the DOS file name of the packet.
  666.  
  667.                Pkt Size -
  668.                     The uncompressed DOS file size.
  669.  
  670.                Conf -
  671.                     This field displays the number of different conferences
  672.                     that messages were created for from within this packet.
  673.  
  674.                Toss -
  675.                     The total number of messages that were tossed from this
  676.                     packet.  This should not be confused with total number
  677.                     of messages that were forwarded, but rather the total
  678.                     number of messages contained within this PKT file.
  679.  
  680.                Sent To Address -
  681.                     This is fairly straight forward here.  This is the
  682.                     address that the PKT file has been addressed to.
  683.  
  684.  
  685.                At the bottom of the report is a summary total for the entire
  686.                days activities.
  687.  
  688.  
  689.  
  690.           WMINFO! v1.02                                          Page 11
  691.           COMMAND LINE OPTIONS
  692.  
  693.  
  694.  
  695.                This report is generated somewhat differently than the way the
  696.                others are.  This is due in part to the sheer size that these
  697.                reports could be.  So WMINFO! will produce this information
  698.                "on the fly" while the processing of the log file is in
  699.                progress.  You'll notice the effect of additional disk
  700.                activity while WMINFO! pauses processing for a moment and
  701.                writes this information to disk before proceeding on with the
  702.                log analysis.
  703.  
  704.  
  705.           /T
  706.                The report generated here contains node specific summary
  707.                information about the mail SENT to their system.  This means
  708.                WILDMAIL! running on your system has forwarded this mail on
  709.                TO them.  The report is generated in the \WILDMAIL directory
  710.                and is appropriately named SUMRY-xx.RPT (where xx is an
  711.                arbitrary number generated by WMINFO! to keep track of the
  712.                individual node addressees) Because of the clarity of this
  713.                report, most all the options are self-explanitory.
  714.  
  715.            ┌──────────────────────────────────────────────────────────────┐
  716.            │ WMINFO! v1.02   Summary Report for 1:203/23   Date: 12/18/92 │
  717.            └──────────────────────────────────────────────────────────────┘
  718.  
  719.  
  720.                      D A I L Y    M E S S A G E    A C T I V I T Y
  721.  
  722.                      Date       Msgs        Bytes       Avg Size
  723.                    ────────    ──────    ───────────    ────────
  724.                    12/01/92       203        248,938      1,226
  725.                    12/02/92       115         94,215        819
  726.                    12/03/92        75        179,287      2,390
  727.                    12/04/92       105        119,164      1,134
  728.  
  729.  
  730.                      A V E R A G E S    I N F O R M A T I O N
  731.  
  732.                           Daily Messages Sent  : 125
  733.                           Daily Bytes Sent     : 160,551
  734.                           Overall Avg Msg Size : 1,392
  735.  
  736.  
  737.                            S U M M A R Y    T O T A L S
  738.  
  739.               Total Days in Report : 4     Total Messages Sent : 498
  740.               Total Conferences    : 13    Total Bytes Sent    : 641,604
  741.  
  742.            ┌─────────────────────── End of Report ────────────────────────┐
  743.            ╘══════════════════════════════════════════════════════════════╛
  744.  
  745.  
  746.  
  747.  
  748.           WMINFO! v1.02                                          Page 12
  749.           COMMAND LINE OPTIONS
  750.  
  751.  
  752.  
  753.           /M
  754.                Using this command line parameter when executing WMINFO! will
  755.                produce a report similar to the /H (Hub Report) except it only
  756.                indicates the mail SENT to the node address.  The report
  757.                generated is called NDMSG-xx.RPT where xx equals the temporary
  758.                node address used by WMINFO!.  The same format and layout
  759.                otherwise is identical to the /H report including the
  760.                automatic pagination.
  761.  
  762.  
  763.           /G
  764.                This option is used to have WMINFO! ZIP up the selected
  765.                reports and generate the Netmail message necessary for
  766.                transmission to the downlink nodes.  This option requires the
  767.                use of any combination of the /T /M /D parameters. (it needs
  768.                at least one report to send!)  If this option is NOT used with
  769.                the /T, /M, or /D parameters, the reports are simply left in
  770.                the \WILDMAIL directory.
  771.  
  772.                WMINFO! will read the contents of the WM.CFG file for the
  773.                location of where to put the Netmail message and where the
  774.                compressed file containing the reports should be moved to
  775.                (this is the outbound directory).  When this option is used,
  776.                WMINFO! will "clean up" after itself by deleting the files in
  777.                the \WILDMAIL directory and placing the ZIP files into the
  778.                OUTBOUND directory.
  779.  
  780.  
  781.  
  782.           NETMAIL MESSAGE GENERATION
  783.  
  784.           WMINFO! creates a standard Netmail message using the FROM: name as
  785.           "WMINFO!" and is addressed TO: "SysOp".  The message status flag
  786.           settings are: PRIVATE, FILE, KILLSENT and LOCAL.  The body of the
  787.           message contains a simple one line message and a tear line
  788.           indicating the message was generated by WMINFO!.
  789.  
  790.           Because WMINFO! executes PKZIP.EXE to do the compressing of the
  791.           reports, WMINFO! creates a temporary batch file in the \WILDMAIL
  792.           directory called IN-PACK.BAT.  This file is what's used to execute
  793.           PKZIP when WMINFO! swaps itself out of memory.  Once the
  794.           compression process is complete, WMINFO! swaps itself back into
  795.           memory, deletes the IN-PACK.BAT file and then exits.
  796.  
  797.           As was mentioned earlier, this is the ONLY compression program
  798.           currently supported, but look to see that change in future releases
  799.           of the program.
  800.  
  801.  
  802.  
  803.           WMINFO! v1.02                                          Page 13
  804.           COMMAND LINE OPTIONS
  805.  
  806.  
  807.  
  808.           Because the reports generated are file attaches and since the
  809.           KILLSENT flag is set, the mailer will normally delete the Netmail
  810.           messages automatically after successful transmission.  The attached
  811.           file however will remain in the OUTBOUND directory.  You should
  812.           therefore periodically check the outbound directory and manually
  813.           delete these files otherwise they will end up taking up disk space
  814.           unnecessarily.
  815.  
  816.  
  817.           SPLITTING OF THE LOG FILE
  818.  
  819.           WMINFO! has the ability to divide up the log file on a monthly
  820.           basis allowing you to better manage the size of this log file.
  821.           Currently, only monthly log splitting is available and if demand
  822.           dictates a change, this will be added into a future release.
  823.  
  824.           Shown below is a description of the split log file option.
  825.  
  826.           /S
  827.                This command line parameter is used to split the log file on
  828.                a monthly basis.  Using this parameter will override any other
  829.                valid parameters except the /L:<filename> and terminates upon
  830.                completion.  When executed, WMINFO! will use the default log
  831.                file name found in WM.CFG unless the /L:<filename> option is
  832.                used.  It will proceed to copy the contents to a file using
  833.                the standard naming convention of WM-mmyy.LOG where "mm"
  834.                indicates the month and "yy" displays the year.
  835.  
  836.                Because WMINFO! has no idea how long the log presently is, it
  837.                will create as many files as is necessary (on a monthly
  838.                basis).  However, if the log file contains less than a full
  839.                months worth of activity, WMINFO! will display a message
  840.                indicating so and the log file will remain intact.
  841.  
  842.                Whenever you use this parameter, WMINFO! will ALWAYS create
  843.                a .BAK (backup file) of the log file in case something goes
  844.                wrong during the split process.  Because this is done as a
  845.                safety measure, it will be up to you to manually delete this
  846.                backup file.
  847.  
  848.  
  849.           EXCLUDING INFORMATION FROM REPORTS
  850.  
  851.           WMINFO! has the ability to limit the inclusion of conference areas
  852.           and node addresses from the various reports.  This option is useful
  853.           for displaying specific conference information and for limiting
  854.           which node addresses are to have reports generated for them.
  855.  
  856.  
  857.  
  858.  
  859.           WMINFO! v1.02                                          Page 14
  860.           EXCLUDING NODE ADDRESSES
  861.  
  862.  
  863.  
  864.           For both node and conference exclusions, WMINFO! uses a standard
  865.           ASCII text type file as a lookup table for automatic reference.
  866.           The basic requirements are that only one item PER LINE you wish to
  867.           have excluded (either a node address or conference name depending
  868.           on what file is used) and that no spaces exist WITHIN the address
  869.           or conference name as defined.  Shown below is a description of the
  870.           various files.
  871.  
  872.  
  873.           EXCLUDING NODE ADDRESSES
  874.  
  875.           EX-NODES.LST is used to specify which node address you do NOT want
  876.           WMINFO! to generate reports for.  This is commonly used to exclude
  877.           your HUB addresses because typically information created for your
  878.           HUB is just backwards of your downlink nodes.  After all, this is
  879.           mail SENT to them so if you generated reports for them, it would
  880.           not indicate the conference activity except for mail that was
  881.           extracted from either your system or your downlink node addresses
  882.           systems.
  883.  
  884.           As was mentioned above, this is a line by line ASCII text file with
  885.           one COMPLETE <zone:net/node> node address per line.  A complete
  886.           address is necessary because WMINFO! doesn't assume any network or
  887.           zone address, so it needs the full address!
  888.  
  889.           If the node address you wish to exclude is a point, then add the
  890.           point number to the end of the address such as 1:161/123.1,
  891.           otherwise do NOT put in the assumed point address of '.0'.  In
  892.           other words, if this is a regular node address, use 1:161/123
  893.           instead of 1:161/123.0. (These are example addresses only!)
  894.  
  895.           Any node address entered in the AREAS.BBS file can be specified in
  896.           this file.  When WMINFO! executes, it searches the WILDMAIL!
  897.           directory for the presence of this file and if it exists, then
  898.           records the various addresses found.
  899.  
  900.  
  901.           EXCLUDING CONFERENCES
  902.  
  903.           EX-CONFS.LST can contain a list of COMPLETE echomail AREA names you
  904.           wish to have excluded from the WMINFO1 - WMINFO5.BBS/ASC series of
  905.           display files created for WILDCAT!.  Because reports are generated
  906.           on a node by node basis, it wouldn't be practical to exclude
  907.           conferences from the /H /M /T reports because those reports make
  908.           extensive use of that information.
  909.  
  910.           This file works exactly the same as EX-NODES.LST does except in the
  911.           place of the node address, you simply enter in the COMPLETE area
  912.           name (as found in the AREAS.BBS file).  Only one area name per line
  913.           with uppercase/lowercase being insignificant.  Just make sure
  914.           there's no spaces in the middle of the area name and only one name
  915.           exists per line.
  916.  
  917.  
  918.  
  919.  
  920.           WMINFO! v1.02                                          Page 15
  921.           SPECIFICATIONS
  922.  
  923.  
  924.  
  925.           SPECIFICATIONS
  926.  
  927.           WMINFO! has been designed to operate in a wide variety of different
  928.           environments and system configurations.  WMINFO! is fully DESQview
  929.           aware, thus will run properly when executed in a DV window.
  930.  
  931.  
  932.           MEMORY REQUIREMENTS
  933.  
  934.           WMINFO! memory needs are dictated by the number of conferences
  935.           (including passthru areas) you have on your system.  Or more
  936.           correctly, the number of conferences defined in your AREAS.BBS
  937.           file.  The memory requirements work out something like 525K
  938.           required for 1,000 conferences and only 325K for 400 conferences.
  939.  
  940.  
  941.           PROCESSING SPEED
  942.  
  943.           WMINFO! has been designed from the ground up to optimize the
  944.           processing speed as much as possible.  While we think you'll be
  945.           satisfied with the performance, the basic processing is completely
  946.           dependant on the number of conferences your system carries.
  947.  
  948.           In other words, since WMINFO! maintains conference specific
  949.           information, the more conferences you have, the longer it takes to
  950.           search for each conferences "storage area" before its statistics
  951.           can be updated.
  952.  
  953.  
  954.           CONFERENCES SUPPORTED
  955.  
  956.           WMINFO! presently supports in excess of 1,000 conferences.  While
  957.           initial testing revealed 1,200 conferences (including passthrus)
  958.           only used a little over 560K of RAM, this should cover the vast
  959.           majority of systems currently.
  960.  
  961.  
  962.           NODES SUPPORTED
  963.  
  964.           Presently, WMINFO! supports up to 75 downlink node addresses.  In
  965.           an effort to reduce the overall memory usage, this number has been
  966.           set to this value.  Should the need arise to have support for more
  967.           node addresses, please contact Online Computer Resources.  This is
  968.           a real simple change.
  969.  
  970.  
  971.  
  972.  
  973.           WMINFO! v1.02                                          Page 16
  974.           TECHNICAL SUPPORT
  975.  
  976.  
  977.  
  978.           TECHNICAL SUPPORT
  979.  
  980.           You may contact Online Computer Resources at 1:161/503 or 1:161/504
  981.           via netmail or by logging on to the BBS for technical support.  We
  982.           can also be reached in the WILDCAT! conference on Fidonet.  Our
  983.           regular business hours are 9am-6pm M-F and 10am-5pm Saturdays PST
  984.           and our VOICE number is (510) 687-1122.
  985.  
  986.           If you wish to leave us a message concerning a question you might
  987.           have, please feel free to dial our BBS at the numbers listed below
  988.           and leave us a message.
  989.  
  990.                     (510) 687-0236 (1:161/503) USR Dual Standard
  991.                     (510) 687-2134 (1:161/504) V.32bis PPI
  992.  
  993.  
  994.           30 DAY EVALUATION COPY
  995.  
  996.           WMINFO! v1.02 is a fully functional, full featured activity log
  997.           analyzer for WILDMAIL! v2.02+.  This program is not disabled in any
  998.           way but does require the use of a special 30 day evaluation key.
  999.           This key is obtainable by dialing the WMINFO! support BBS at the
  1000.           number listed above.
  1001.  
  1002.           This temporary key will allow WMINFO! to run FOR 30 DAYS without
  1003.           registration, after which, the program will simply cease to run.
  1004.           This should be sufficient time to properly evaluate the program for
  1005.           fitness prior to its actual registration.
  1006.  
  1007.           After you register the program, you will receive the WMIN.ID file
  1008.           and then by placing it in the \WILDMAIL directory, it will
  1009.           reactivate the program for normal use.
  1010.  
  1011.  
  1012.           PRODUCT REGISTRATION
  1013.  
  1014.           We are releasing WMINFO! at a special introductory price of $15
  1015.           plus $2 shipping/handling up UNTIL the release of WILDMAIL! v3.00.
  1016.           After WILDMAIL!'s v3.00 release, the price will go up to $25 (plus
  1017.           $2 S/H).  The best thing you can do is register the product BEFORE
  1018.           the price goes up and enjoy the $10 savings.
  1019.  
  1020.           Included in the ZIP archive you received WMINFO! in is a file
  1021.           called REGISTER.DOC.  This file should be used when mailing in your
  1022.           registration.  All payments made by check will have a 10 day hold
  1023.           on them until the check has had time to clear the bank prior to
  1024.           shipment.  You may also register WMINFO! by picking up the phone
  1025.           and dialing (510) 687-1122 and placing your order by voice.  Be
  1026.           sure and have your credit card handy.  This is by far the fastest
  1027.           and most efficient manner as the registered key files are usually
  1028.           put up for download before 5pm PST daily.
  1029.  
  1030.  
  1031.  
  1032.           WMINFO! v1.02                                          Page 17
  1033.           LICENSING AND DISTRIBUTION AGREEMENT
  1034.  
  1035.  
  1036.  
  1037.           Copyright (C) 1991, 1992 by Online Computer Resources.  ALL RIGHTS
  1038.           RESERVED.  COMMERCIAL DISTRIBUTION AND/OR USE PROHIBITED WITHOUT
  1039.           WRITTEN PERMISSION FROM Online Computer Resources.
  1040.  
  1041.           Non-Commercial distribution and/or use is permitted under the
  1042.           following terms:
  1043.  
  1044.           1)   You may copy and distribute copies of WMINFO! executable code
  1045.                as you receive it, in any medium, provided that you do so in
  1046.                a lawful, friendly manner and that you conspicuously and
  1047.                appropriately publish on each copy of each file that is a part
  1048.                of the distribution package a valid copyright notice:
  1049.  
  1050.                "Copyright (C) 1991, 1992 by Online Computer Resources.  Any
  1051.                copies that you distribute must be distributed free of charge
  1052.                to the recipient of the copy.  WMINFO! may not be sold and you
  1053.                may not rent or lease it to any other person."
  1054.  
  1055.           2)   You must keep this License Agreement intact and give any other
  1056.                recipients of the WMINFO! program a copy of this License
  1057.                Agreement along with the program.
  1058.  
  1059.           3)   You must distribute WMINFO! in unmodified form.  You may not
  1060.                add an advertisement for your Bulletin Board System, User
  1061.                Group, or anything else either as a file in the distribution
  1062.                packet or as a header in any archive.  You may not add, modify
  1063.                or delete any of the files in the WMINFO! distribution
  1064.                archive.
  1065.  
  1066.           4)   WMINFO! must be distributed for free. You may not charge a
  1067.                distribution fee for the physical act of transferring a copy
  1068.                of this program.  You may not place this program in any file
  1069.                area of a Bulletin Board System where a fee is required for
  1070.                download.
  1071.  
  1072.           5)   You may not modify your copy or copies of WMINFO! or any
  1073.                portion of it and you can not copy and distribute any
  1074.                modifications. WMINFO! is distributed in ZIP format and you
  1075.                may not distribute it in any other form!
  1076.  
  1077.           6)   You may not copy, sublicense, distribute or transfer WMINFO!
  1078.                except as expressly provided under this License Agreement.
  1079.                Any attempt otherwise to copy, sublicense, distribute or
  1080.                transfer WMINFO! is void and your rights to use the program
  1081.                under this License agreement shall be automatically
  1082.                terminated.
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.           WMINFO! v1.02                                          Page 18
  1089.           LICENSING AND DISTRIBUTION AGREEMENT
  1090.  
  1091.  
  1092.  
  1093.           7)   You may not incorporate parts of WMINFO! into other programs
  1094.                without the written permission of Online Computer Resources.
  1095.                Permission may or may not be granted based upon a
  1096.                determination of what your intended use is.
  1097.  
  1098.           8)   For the purposes of this document, "COMMERCIAL USE" is defined
  1099.                as concurrent operation of the software on three or more
  1100.                computers or data lines owned by the same for-profit
  1101.                organization.  Any organization may operate this software
  1102.                under the terms of this Non-Commercial Agreement if operation
  1103.                is limited to two or less computers or data lines.
  1104.  
  1105.           9)   You may use the software only after understanding and agreeing
  1106.                upon the above terms.
  1107.  
  1108.  
  1109.  
  1110.           NO WARRANTY
  1111.           ===========
  1112.  
  1113.           WMINFO! v1.02 IS DISTRIBUTED AS AN EVALUATION COPY ONLY!  THIS
  1114.           PROGRAM REQUIRES THE USE OF A SPECIAL 30 EVALUATION KEY OBTAINABLE
  1115.           FROM THE WMINFO! SUPPORT BBS AT (510) 687-0236.  IF, AT THE END OF
  1116.           THE 30 DAY PERIOD, YOU HAVE NOT REGISTERED THE PRODUCT, WMINFO!
  1117.           WILL SIMPLY CEASE TO RUN.  REACTIVATION REQUIRES THE PLACEMENT OF
  1118.           THE REGISTERED KEY FILE IN THE WILDMAIL! DIRECTORY.
  1119.  
  1120.           THIS PROGRAM IS GUARANTEED TO DO ABSOLUTELY NOTHING EXCEPT TAKE UP
  1121.           DISK SPACE.  USE IT AT YOUR OWN RISK.  NEITHER ONLINE COMPUTER
  1122.           RESOURCES NOR ANY OTHER PERSON INVOLVED IN IT'S DISTRIBUTION IS
  1123.           RESPONSIBLE IN ANY WAY, FOR ANY DAMAGES RESULTING FROM ITS USE OR
  1124.           MISUSE, DIRECTLY OR INDIRECTLY.
  1125.  
  1126.           THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF WMINFO! IS
  1127.           ENTIRELY WITH YOU.  SHOULD WMINFO! PROVE DEFECTIVE, YOU ASSUME THE
  1128.           COST OF ALL NECESSARY SERVICING, REPAIR OR OTHER DAMAGES TO YOUR
  1129.           EQUIPMENT, SOFTWARE, OR OTHER PROPERTY.
  1130.  
  1131.           ONLINE COMPUTER RESOURCES IS NOT RESPONSIBLE TO YOU FOR DAMAGES,
  1132.           INCLUDING BUT NOT LIMITED TO, ANY LOST PROFITS, LOST MONIES, OR
  1133.           OTHER SPECIAL, GENERAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  1134.           OUT OF THE USE OR INABILITY TO USE (INCLUDING BUT NOT LIMITED TO
  1135.           LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED
  1136.           BY THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
  1137.           OTHER PROGRAMS) OR ANY OTHER LOSS EVEN IF YOU HAVE BEEN ADVISED OF
  1138.           THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER
  1139.           PARTY.
  1140.  
  1141.